Shareware Grab Bag

home *** CD-ROM | disk | FTP | other *** search

/ Shareware Grab Bag / Shareware Grab Bag.iso / 013 / scr.arc / SCR.TXT < prev next >

Wrap

Text File | 1985-06-10 | 21.5 KB | 672 lines

tm T I Y L I S O F T W A R E is proud to present +----------------------------------------+ | The Screen Image Editor | | | | and Batch Utility | | | | by | | Frank M. Ramaekers Jr. | +----------------------------------------+ (c) Copyright 1984,85 "Try-It-You'll-Like-It" Software (c) Copyright 1984,85 Frank M. Ramaekers Jr. User-supported Software 01/28/85 Screen Image Editor and Batch Utility V2.1c Page i Table of Contents: 0.0 The User-supported Concept . . . . . . . . . . . . . . . . . . . . . . 1 1.0 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1.2 The Screen Image Editor . . . . . . . . . . . . . . . . . . . . . 1 1.3 The Batch Utility . . . . . . . . . . . . . . . . . . . . . . . . 2 1.4 Minimum Requirements . . . . . . . . . . . . . . . . . . . . . . 2 2.0 Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 2.1 The Screen Image Editor . . . . . . . . . . . . . . . . . . . . . 2 2.1.1 Function Key Assignments . . . . . . . . . . . . . . . . . 2 2.1.2 Alternate Function Key Assignments . . . . . . . . . . . . 3 2.1.3 Control Key Assignments . . . . . . . . . . . . . . . . . 3 2.1.4 Special Key Assignments . . . . . . . . . . . . . . . . . 4 2.1.5 Alternate Key Assignments . . . . . . . . . . . . . . . . 4 2.1.6 Graphic Keyboard Layout . . . . . . . . . . . . . . . . . 4 2.1.7 Line 25 Information . . . . . . . . . . . . . . . . . . . 4 2.1.8 Color Chart . . . . . . . . . . . . . . . . . . . . . . . 5 2.2 The Batch Utility . . . . . . . . . . . . . . . . . . . . . . . . 5 2.2.1 Command Format . . . . . . . . . . . . . . . . . . . . . . 5 2.2.2 Examples . . . . . . . . . . . . . . . . . . . . . . . . . 6 2.2.3 A Batch File Example . . . . . . . . . . . . . . . . . . . 6 2.3 The Conversion Utility . . . . . . . . . . . . . . . . . . . . . 8 3.0 Registration Form . . . . . . . . . . . . . . . . . . . . . . . . . . 9 (c) Copyright 1984,85 Frank M. Ramaekers Jr. User-supported Software 01/28/85 Screen Image Editor and Batch Utility V2.1c Page 1 0.0 The User-supported Concept ---------------------------------- This product is distributed on a basis that the product will sell itself. This reduces advertising, distribution, and copy-protection costs. This means that you can copy and share this program with others, on the conditions that the program is not distributed in modified form and that no fee or other consideration is charged. The only thing I ask is that if you find this product of value, please send a donation ($24 suggested) to the following address: Frank M. Ramaekers Jr. 4614 Arapahoe Tr. Austin, Texas 78745 Your contribution entitles you to the following: 1) The latest version of this system. Which will be mailed to you upon receipt of your donation. 2) When a new version is available, you will be notified. You will then have the option of sending your original (with return postage) for this new version. 3) You will also be notified of future products. 4) Responses to questions, complaints or problems that you send in. 1.0 Introduction -------------------- 1.1 Overview ------------- The Screen Image processing system was created to assist in creating menus and help screens. Current DOS batch commands (e.g. ECHO and REM) provide only line-by-line creation of a screen image that was extremely slow. Also, these batch files were very tedious to edit, especially if graphic characters were used. In addition, neither command provides for attribute selection. Plus, DOS makes no provisions for keyboard input to facilitate the selection process. The SCREDIT.COM program provides a method of retrieving, editing and saving screen images that can be used in a batch file. SCRBATCH.COM was created to display the screen image and optionally accept a response from the keyboard and set the ERRORLEVEL (so it can be tested using the IF batch subcommand). 1.2 The Screen Image Editor ---------------------------- The Screen Image Editor is a utility by which users can maintain screen images. Screen images can be loaded, edited, and saved. Most of the common graphic characters are easily accessable through the keyboard and are arranged in a conevient layout. All the major editing functions are incorporated into this editor. In addition, the editor allows full utilization of all attributes in either black & white or color. Also, an interactive help facility is provided. This facility provides information on all key assignments. (c) Copyright 1984,85 Frank M. Ramaekers Jr. User-supported Software 01/28/85 Screen Image Editor and Batch Utility V2.1c Page 2 1.3 The Screen Image Batch Utility ----------------------------------- The Batch Utility provides a means of displaying screen images created by the editor. This utility also includes a means of accepting input (via the keyboard) and setting the ERRORLEVEL. In turn, a batch file can test the ERRORLEVEL (with the IF batch subcommand) and process the request accordingly. 1.4 Minimum Requirements ------------------------- 1) An IBM PC (tm) or compatible. 2) PC or MS DOS 2.0 or higher. 3) A Minimum of 64k of memory 4) One monitor card & monitor (color or monochrome). 5) At least one single-sided diskette drive. 6) The following programs: SCREDIT.COM SCRBATCH.COM SCRHELPA.COM SCRHELPB.COM SCRHELPC.COM SCRHELPD.COM SCRHELPE.COM 2.0 Instructions ----------------- 2.1 Screen Image Editor ------------------------ To invoke the screen image editor, insert the program diskette, then enter SCREDIT then press enter. There are no operands nor options. A>SCREDIT 2.1.1 Function Key Assignments ------------------------------- F1 - Toggle between Text(standard)/Graphics keyboard layouts. When initialized SCREDIT will have the standard keyboard layout. Pressing the F1 key will toggle to the graphics keyboard layout (hexadecimal characters 80 - FF). F2 - Toggle foreground blink attribute. This will toggle the foreground blink attribute bit. F3 - Swap background/foreground attributes. This will logically swap the background/foreground attributes. Blink and highlight cannot be swapped and are retained. Therefore, the background (foreground after swap) attribute will reflect the blink and highlight settings. F4 - Toggle bright foreground attribute. This will toggle the foreground bright attribute bit. F5 - Increase foreground attribute value. This will logically increment the current value of the foreground attribute (black [0] will become blue [1], blue [1] will become green [2], ... white [F] will become black [0]). (c) Copyright 1984,85 Frank M. Ramaekers Jr. User-supported Software 01/28/85 Screen Image Editor and Batch Utility V2.1c Page 3 2.1.1 Function Key Assignments (cont.) --------------------------------------- F6 - Decrease foreground attribute value. This will logically decrement the current value of the foreground attribute (blue [1] will become black [0], green [2] will become blue [1], ... black [0] will become white [F]). F7 - Increase background attribute value. This will logically increment the current value of the background attribute (black [0] will become blue [1], blue [1] will become green [2], ... white [7] will become black [0]). F8 - Decrease background attribute value. This will logically decrement the current value of the background attribute (blue [1] will become black [0], green [2] will become blue [1], ... black [0] will become white [7]). F9 - Load screen image from disk. F10 - Save screen image to disk. 2.1.2 Alternate Function Key Assignments ----------------------------------------- Alt-F1 - Help information which includes all key assignments. Alt-F5 - Clear screen using the current attribute setting. Alt-F9 - Exit temporarily to DOS. (Use the EXIT command to return.) Alt-F10 - Return to DOS. 2.1.3 Control Key Assignments ------------------------------ ^2 - Set/Clear tab settings. (use cursor/tab-key to position, T to set/clear) ^A - Move cursor to beginning of previous word. ^D - Move cursor forward one character. ^E - Move cursor up one line. ^F - Move cursor to beginning of next word. ^G - Delete character at cursor position. ^H - Delete character before cursor position. ^I - Tab forward. ^J - Left justify line. ^K - Center line. ^L - Right justify line. ^M - Move cursor to beginning of next line. ^N - Move remainder of line to next line. ^Q - Delete previous word. ^S - Move cursor backward one column. ^T - Delete next word. ^V - Toggle to/from insert mode. ^X - Move cursor down one line. ^Y - Delete line. (Note: Functions ^G, ^H, ^N, ^Q, ^T and ^Y fill using the current attribute and a space for the character.) (c) Copyright 1984,85 Frank M. Ramaekers Jr. User-supported Software 01/28/85 Screen Image Editor and Batch Utility V2.1c Page 4 2.1.4 Special Key Assignments ------------------------------ -> - Move cursor right one column. <- - Move cursor left one column. ^ - Move cursor up one row. v - Move cursor down one row. <--> - Tab key. Home - Move cursor to first character on line. End - Move cursor to last character on line. Pg Up - Move cursor to row 1, column 1. Pg Dn - Move cursor to row 24, column 80. Ins - Toggle to/from insert mode. Del - Delete character above cursor. ^-> - Move cursor to next word. ^<- - Move cursor to previous word. ^Home - Erase to beginning of line. ^End - Erase to end of line. ^Pg Up - Erase to beginning of screen. ^Pg Dn - Erase to end of screen. Sh <--> - Backward tab (Sh is the shift key). (Note: All erase functions fill using the current attribute and a space for the character.) 2.1.5 Alternate Key Assignments -------------------------------- Please see page 4 of the help facility (Alt-F1) for this information. 2.1.6 Graphic Keyboard Layout ------------------------------ Please see page 3 of the help facility (Alt-F1) for this information. 2.1.7 Line 25 Information -------------------------- Please see page 5 of the help facility (Alt-F1) for this information. (c) Copyright 1984,85 Frank M. Ramaekers Jr. User-supported Software 01/28/85 Screen Image Editor and Batch Utility V2.1c Page 5 2.1.8 Color Chart ------------------ The attribute byte of the screen image has the following format (in binary): XYYY ZZZZ. Where X is the forground blink toggle. YYY is the background color and ZZZZ is the foreground color. ------------------------------------------- | Hex. | Binary | Background | Foreground | -------+--------+------------+------------+ | 0 | 0000 | Black | Black | | 1 | 0001 | Blue | Blue | | 2 | 0010 | Green | Green | | 3 | 0011 | Cyan | Cyan | | 4 | 0100 | Red | Red | | 5 | 0101 | Magenta | Magenta | | 6 | 0110 | Yellow | Brown | | 7 | 0111 | White | Light Grey | | 8 | 1000 | (the | Dark Grey | | 9 | 1001 | high-order | Light Blue | | A | 1010 | bit | Lt. Green | | B | 1011 | is | Light Cyan | | C | 1100 | used | Light Red | | D | 1101 | for | Lt. Magenta| | E | 1110 | foreground | Yellow | | F | 1111 | blink) | White | ------------------------------------------- 2.2 The Batch Utility ---------------------- 2.2.1 Command Format --------------------- A>SCRBATCH [d:] [path\] filename [.SCR | .ext] [/a | /c | /n | /pnnn | /q] [/i @xxxxxxxxxxxxxxxxxxxxxxxxxxxxx@] [/o##] d: - Drive of screen image. path\ - Path to screen image. filename- Filename of screen image .ext - Extension of screen image (.SCR assumed). /a - Ask (return ERRORLEVEL=ASCII of key struck, translated to upper case.) /c - Ask Character (return ERRORLEVEL=0 if 'A' key struck, 1 of 'B' key struck ... 25 if 'Z' key struck. The character is translated to upper-case.) /i - Line 25 input prompt (first non-blank character after the 'i' will be the delimiter for the string) /n - Ask Numeric (return ERRORLEVEL=0 if '0' key struck, 1 if '1' key struck ... 9 if '9' key struck) /o - Override attribute on line 25 (## is valid hex code, default attribute is 07 - normal - white on black) /pnnn - Wait for nnn seconds or until a key is pressed if nnn is equal to zero or omitted. /q - Query (return ERRORLEVEL=0 if 'y' or 'Y' key struck or ERRORLEVEL=1 if 'n' or 'N' key struck.) (c) Copyright 1984,85 Frank M. Ramaekers Jr. User-supported Software 01/28/85 Screen Image Editor and Batch Utility V2.1c Page 6 2.2.1 Command Format (cont.) ----------------------------- Notes: a) The complete file name (drive, path, filename and extension must be the first parameter. Options are position inde- pendent. b) If more than one of the following options is specified, the first one issued from this list will take presidence: /p /q /a /n /c c) SCRBATCH.COM must be on each diskette that utilizes it. 2.2.2 Examples --------------- A>SCRBATCH C:\SCR\SCRHELPA /P /I'Press any key to continue'/o87 This will display the screen SCRHELPA.SCR in sub-directory SCR and wait for a key to be pressed. On line 25 the prompt 'Press any key to continue' will be centered and blinking (87h attribute). A>SCRBATCH C:SCRHELPA.XXX /Q /I [Please respond by pressing the 'y' or 'n' key[ This will display the screen image SCRHELPA.XXX and set the ERRORLEVEL to 0 if a 'y' or 'Y' and to 1 if 'n' or 'N' key was struck. In addition a prompt is displayed centered on line 25. A>SCRBATCH C:HELP01 /A This will display the screen image HELP01. The ERRORLEVEL will be set to the ASCII value of the key that was struck. A>SCRBATCH HELP01A /i'Select 0 through 9 from list above.'/n/o8f This will display the screen image HELP01A.SCR. The ERRORLEVEL will be set to the value 0 - 9 corresponding to keys '0' - '9'. Also, a prompt message will appear centered on line 25 with a blink & bright attribute. 2.2.3 A Batch File Example --------------------------- 1) SCRBATCH \HELP\LOGO /P3 2) :BEGIN 3) SCRBATCH \HELP\MENU/I'Select 0 through 9 from list above.'/8f/n 4) IF ERRORLEVEL 10 GOTO BEGIN 5) CLS 6) IF ERRORLEVEL 9 GOTO EXIT 7) IF ERRORLEVEL 8 GOTO TREE 8) IF ERRORLEVEL 7 GOTO CHKDSK 9) IF ERRORLEVEL 6 GOTO DIR 10) IF ERRORLEVEL 5 GOTO BASICA 11) IF ERRORLEVEL 4 GOTO BASIC 12) IF ERRORLEVEL 3 GOTO TALK 13) IF ERRORLEVEL 2 GOTO DBASE 14) IF ERRORLEVEL 1 GOTO LOTUS 15) IF ERRORLEVEL 0 GOTO WS 16) :WS 17) CD \WS 18) WS 19) GOTO BEGIN 20) :LOTUS 21) CD \LOTUS (c) Copyright 1984,85 Frank M. Ramaekers Jr. User-supported Software 01/28/85 Screen Image Editor and Batch Utility V2.1c Page 7 2.2.3 A Batch File Example (cont.) ----------------------------------- 22) LOTUS 23) GOTO BEGIN 24) :DBASE 25) CD \DBASE3 26) ECHO Insert the DBASE III system diskette into drive A: (left drive). 27) ECHO 28) PAUSE 29) DBASE 30) GOTO BEGIN 31) :TALK 32) CD \TALK 33) PC-TALK 34) GOTO BEGIN 35) :BASIC 36) CD \BASIC 37) BASIC 38) GOTO BEGIN 39) :BASICA 40) CD \BASIC 41) BASICA 42) :DIR 43) DIR|MORE 44) PAUSE 45) GOTO BEGIN 46) :CHKDSK 47) CHKDSK 48) PAUSE 49) GOTO BEGIN 50) :TREE 51) TREE/F|MORE 52) PAUSE 53) GOTO BEGIN 54) :EXIT 55) CD / Statement 1 displays the screen image LOGO.SCR in sub-directory \HELP for 3 seconds. The next statement (2) is a label that will be used later to redisplay the menu screen. Statement 3 displayse the screen image MENU.SCR in sub-directory \HELP until a valid key (0-9) is struck. In turn, the ERRORLEVEL will be set corresponding to the key struck. In the next statement (4), invalid responses are filtered out (although the ERRORLEVEL will never be set to 10, this is to demonstrate how edit the responses). The purpose of statement 5 is to clear the screen before the program is executed. The next statement (6) checks if the key struck was 9, if so a branch is made to the label :WS. (Notice that the highest value of ERRORLEVEL is filtered off first. This is because the 'IF ERRORLEVEL' batch subcommand operates on a greater than or equal to premise.) In statement 16 has the label :WS. The next statement (17) changes the current directory to \WS. Statement 18 actually executes WordStar. When WordStar is terminated statement 19 is executed which branches back to redisplay the menu. (c) Copyright 1984,85 Frank M. Ramaekers Jr. User-supported Software 01/28/85 Screen Image Editor and Batch Utility V2.1c Page 8 2.2.3 A Batch File Example (cont.) ----------------------------------- This batch file makes no attempt to reset the directory after each program is executed. For this reason each change directory statement (CD) starts at the root directory (\). Then upon exit from the batch file the current directory is reset to the root. 2.3 The Conversion Utility --------------------------- This utility program will convert a screen image file (.SCR) to either a BASIC BLOAD file or a standard ASCII file. Also available is conversion to a screen image file from either a BASIC BLOAD file or a standard ASCII file. To invoke the Conversion Utility enter SCRCONV and press enter. A>SCRCONV (c) Copyright 1984,85 Frank M. Ramaekers Jr. User-supported Software 01/28/85 Screen Image Editor and Batch Utility V2.1c Page 9 ------------------------------------------------------------------------------- Screen Image Editor Registration Form v2.1c Name: _______________________________________________ Date:____/____/____ (Last) (First) (Middle Initial) (MM DD YY) Address: -------------------------------------------- City: _______________________ State: _______________ Zip Code: _____________ Amount Enclosed: ___________________ +------------------------------------- |********** DO NOT MARK HERE ********* Send to: Frank M. Ramaekers Jr. | 4614 Arapahoe Tr. | Serial No.___________________ Austin, Texas 78745 | | Version No.__________________ | | Date issued:_________________ ------------------------------------------------------------------------------- (c) Copyright 1984,85 Frank M. Ramaekers Jr. User-supported Software